Add handling for a spectators list in addition to the players list

The model is that when people initially join the game, (providing a
name for themselves), they are a spectator. They then move from the
spectator list to the player list when then they choose a character
name.

The server isn't very clever about this. It has distinct endpoints for
adding/removing players and adding/removing spectators. So in this
code we have to explicitly remove ourselves as a spectator when we add
ourselves as a player.

empires: Construct reliable paths for all game API endpoints

By appending to window.location we can ensure that we're always
hitting an endpoint one level below the game ID, (and not replacing
the game ID), regardless of whether the current path ends in a
trailing slash or not.

empires: Simply game for to require only a character name

Since the palyer's own nickname is now requested earlier (when first
joining the game).

This will hopefully be less confusing for players (who were sometimes
confused about which name was which).

Merge branch 'flempires-repo-merge'

This brings in the files which were originally being tracked at
https://gitlab.com/kworth082/empires.git

Rename flutterempires to flempires

Because its way more nerdy to have a corny name for an app, so
flempires it is (or at least its directory).

Prepare directories for merge into lmno.games

In order to merge this (flutterempires) repo into the lmno.games repo,
it will be much cleaner to have all of the files in the top level
directory named flutterempires in order to avoid conflicts with
top-level files in lmno.games.

Add all linux files generated with flutter create .

Accordingly with this documentation:

    https://flutter.dev/desktop#add-desktop-support-to-an-existing-flutter-project

This commit adds all of the files in the `linux` directory which came
from running `flutter create .` while on the master branch of
flutter-sdk.

Merge branch 'add-macos'

Merge branch 'player-list'

Enable network requests in mac os app

According to documentation here:

    https://flutter.dev/desktop#setting-up-entitlements

this change is needed so that the app can send network requests

Merge branch 'data-models'

Get rid of extra FutureBuilder widgets

Now that the ListView is working correctly, we can get rid of these two
FutureBuilders which were essentially intermediate steps to get to this
point.

Add all macos files generated with flutter create .

According to this documentation:

    https://flutter.dev/desktop#add-desktop-support-to-an-existing-flutter-project

This commit adds all of the files which came from running `flutter
create .` while on the master branch of flutter-sdk.

After this commit (and while still on the flutter-sdk master branch) the
native mac os app can be run with `flutter run -d macOS`.

Change name of Android app to Empires

The generated code lazily made the app name match the package
name, so now Empires is much better than flutterempires.

Clean up some leftover hello flutter code

The hello flutter code has button which increments a number on the
screen and this has just been cluttering things up. This will likely be
a good place to put the logic we'll need for submitting the user's
name and character, so we won't get rid of it completely.

Show text if player list returns empty

Better to show "No players yet" than nothing when the server returns an
empty list.

Merge branch 'families-to-empires'

Rename everything that was initially created with `flutter create flutterfamilies`
so that it is now called "flutterempires" instead

Make space for showing the full list of players

Up to now, the widgets were centered on the screen. With them now moved
up to the top, there is room to show the list of players at the bottom.

Clean up indentation

This commit changes whitespace only, now that the FutureBuilder is
inside the Expanded widget.

Clean up by removing some tutorial text

Removes comments only - no functional code changes

Rename directory flutterfamilies to flutterempires

Originally the flutter app was created in a directory called flutterfamilies
and this should take care of the final references still pointing to that old
directory now that it's renamed to flutterempires

Display total number of players

Setting up a new widget to display the list of players, but for the
time being (for simplicity's sake) it's just displaying the size of the
returned list of players.

Add Expanded to fix the scrollable in a scrollable problem

Since the ListView can't be put into the Column widget, we
instead add an Expanded widget and put the ListView in there.

Fix indentation after adding Container

Changes whitespace only

Rename "Families" to "Empires"

Because the name is better

Add fetchAllPlayers method

This method is really the one we've needed all along and so now we
can display the list of players instead of just the first player.

Move the FutureBuilder into the Column (does not work)

Again, this is a commit to get us back to the broken state before more
properly fixing things.

Add new Container to allow for margin

The Center widget can't have margin, apparently, so we'll put it in
a Container which can.

Rename application id to com.appsiom.empires

Because com.example was no good and so was flutterfamilies

Stop using dart:js in player.dart

This "web only" package was preventing the app from being built on
Android and iOS, so now that we have a method for parsing the player
list, we no longer need to use the (albeit simpler) JsArray type.

See: https://dart-lang.github.io/linter/lints/avoid_web_libraries_in_flutter.html

Put back the Column in main.dart

This is a quasi-revert of e318ede47bc5b8563db84ce2c676c6a9297c860e

...where we took a shortcut by removing a bunch of stuff just to get
things to work, now we're putting it back in the broken state and some
following commits will fix it.

Add README.md

Add method parsePlayers to player.dart

This gives us a convenience method to parse the
json returned from the server into a List<Player> object

Add another screenshot to the README

The README now has two screenshots in order to
demonstrate how the list of players can be updated
(by clicking on the "plus" button).

Add screenshot to root for current progress

Change fetchPlayer to fetchFirstPlayer

Initially I was going to fix the logic in this method to fit the name,
but instead - for the time being - I'll simply make the name more
accurately describe what the method is doing.

Update screenshot for README

The newest screenshot is now showing the game on an Android
emulator with a list of players.

Add some space in between TextFields for aesthetics

Add initState to start the async call to fetch player

initState is a good place to do asynchronous calls that we just
need to happen one time at the beginning.

So, in initStart we fetch the player and put it in a Future, and then
when (each and every time) build gets called, it uses what has
been fetched or shows the spinner if the fetch hasn't completed
successfully yet.

Make the plus button act like refresh

Tapping on the plus button now calls fetch again and redisplays the
updated list of players

Add label and TextField for entering the player's game name

Add a FutureBuilder widget to hold a fetched player

Rather than doing a fetch within this build method (which gets called repeatedly),
we use a FutureBuilder to show a spinner until the player has finished being
fetched asynchronously.

Rip out column and just show player list view

This was the easiest thing to do quickly, because a list view does not
play nicely inside of a column widget (can't put a scrollable inside of
a scrollable, sort of thing...)

Eventually, we need to combine the views or make separate screens for
each one.

Add TextField for entering (real) name

Add class RegisteredUser with name and character attributes

This data model will be used when POSTing to /register

See:
    git://git.cworth.org/git/empires-api/api.text
    at commit 0411bdc

Add 'Empires' to homepage title

Add class Player with id and name attributes

This data model will be used when hitting the /players endpoint

See:
    git://git.cworth.org/git/empires-api/api.text
    at commit 0411bdc

Change app name to 'Families Game'

Add http library version 0.12.1 to pubspec.yaml

Add all from `flutter create <name>`

lmno.js: Drop the lmno_login and lmno_login_loadend functions

These were supporting some code in a separate repository (lmno-server)
but that repository has now gotten smart enough to host its own
JavaScript code so this is currently serving no purpose here.

Use an absolute path for the events API

Again, from a bug report where a user's browser was unable to fetch
this resource.

Use absolute references for CSS and JS files

I wouldn't expect this to have a behavioral change, but I recently got
a bug report from some users who where unable to get these resources,
(their browser was trying to fetch them from
https://lmno.games/game.css instead of
https://lmno.games/epires/game.css).

Add JavaScript handling for the recently-added login form

The HTML for this login form isn't seen here. It exists inside of
lmno-server.

Add an "lmno_" prefix to our loadend functions

This gives a more natural binding between, for example, lmno_join and
lmno_join_loadend.

Drop debugging statement to console.log

We don't really intend to clutter up the browser console like this.

Actually make the top-level "join game" button work.

Embarrassingly enough, when I first implemented the handling of this
form, I only tested that it gave a proper error message for an invalid
ID. Somehow I totally neglected to even test (let alone implement!)
the handling of a valid ID.

Fortunately, the missing implementation is _very_ easy. Just send the
browser to the URL for the game ID that was entered.

Fix a typo: "fot" instead of "for"

And while fixing that, cleaning up the surrounding sentence.

Add the standard viewport element

I wish this were the default. I'm always having to receive a report
that it's broken before I realize what's going on.

Add a link from the top-level page to the static page Empires

So that it's actually possible to find how to host a new game

Add basic them-based styling of link colors

Since the default lnik colors are _horrible_.

empirs: Switch to using local server to handle all game events

The local server is now much more capable than the old one at
https://families.cworth.org/api (since the local one can now
handle multiple simultaneous games each with a different ID).

empires: Fix references to "local" CSS and JS files

While it's tempting to just treat these as coming from the current
directory, in practice this HTMl page will be served from a dynamic
path that includes the game ID as a path component. So we have to
look up one directory to find these resources.

empires: Add a top-level static page for the Empires game

This has a basic description of the game along with a button to host a
new instance of the game.

There is a tiny bit of JavaScript added to support the new button,
(simply calling the server API to generate a new game and then
redirecting to the new game ID or else generating an error message).

style: Add some padding at the bottom of any form

This is some really basic style that is sorely needed by default.

It's also exactly the styling that was missing that motivated be to
put a gratuitous <br> in here earlier. So we take that out here.

style: Add some basic support for a bulleted list.

It's somewhat surprising that the reset.css even removes all bullets
from list items, but there you have it.

style: Remove some duplicated code between h1 and h2

By adding one block for both h1 _and_ h2 to hold common properties.

empires: Fix indentation of game.html

There were a couple of misguided attempts to keep content closer to
the left column here, but were in fact just inconsistent
indentation. Fix things up to be consistently indented according to
the actual document structure.

empires: Rename all files (html, js, and css) to game.*

These are all the files for manipulating a single instance of a
game. We're moving this away from index.html so that we can have a
separate page at index.html for giving game instructions and allowing
users to host a new game.

So, along with the new name of game.html, we also rename supporting
files to game.css and game.js to be consistent.

make deploy: Go back to deleting any pre-existing files on the server

We stopped doing this back in commit
0bce98367c70c43eaa425aad101e15ed3db612a8 specifically because I was
concerned about a deployment of the top-level "lmno.games" content
obliterating lower-level content (such as that deployed by the
"empires-html" repository).

But now, I've switched to hosting the empires HTML content in this
same repository where it will be deployed together. And that's my plan
going forward, to house all static HTML content here in this
lmno.games repository. So in this commit we start passing the --delete
flag to rsync again.

The one exception is the "flempires" directory where Kevin is
currently experimenting. In the future, we'll likely incorporate that
content into this repository as well. But for now, we simply
explicitly exclude it so that deployments here won't destroy anything
he has deployed there.

0bce98367c70c43eaa425aad101e15ed3db612a8#

Add some comments on the CSS for styling the empires client

At this point, all of the generic styling, (for paragraphs, forms,
etc.), has been moved up to the top level. So the only styling left at
the level of the empires directory are things to set very
empires-specific things, (such as showing/hiding elements for
particular game states).

Use named color to set the character of the character-reveal element

This makes me so happy! With these named colors, a low-level style
file like this one now has no explicit color values in it, but instead
simply inherits the defined, named colors from the theme above.

Move input sizing from empires to top-level

There's no reason the empires client should be overriding the size of
input fields. These should be consistent across all games.

And we choose the size of 40 that the empires client had, which is
slightly smaller than what we were getting otherwise, (which looked
just a tiny bit, comically large).

Move paragraph-spacing from empires/style.css to style.css

This is a useful spacing directive, so we want it applied at the
top-level, not just in the empires directory.

Apply our selected text color to haeaders (h1 and h2)

This was previously happening in the empires client, but now we move
this up to the top-level.

Note that we don't use the selected text color at minimal font sizes
(such as in the "body" element in general). This is because we want a
high contrast there for maximal legibility. So we introduce an
additional named --text-fo-color-max-contrast which is set to pure
black.

Use CSS custom properties to define named colors

Hurrah! I've only wanted this feature for decades.

Thanks to Richard for pointing out that it's now been well-supported
long enough that I can reliably use it. This will really help so that
I can change colors in one place and have the entire style follow the
scheme.

Insert a line break before the "Players in the game" section

It would be more semantic to have actual "sections" in the content and
some styling that sets proper spacing between sections. But that feels
like overkill given the current simplicity of the page, and the
current problem that there was just too little space at this one
point.

If we do make the page more complex in the future, we can certainly
add semantic sections.

Fix the page width to allow the content to be a full 720px wide

The code that was written here with numeric values of 720px was
assuming that the page interior would be as wide as 720px and that
padding would not be counted in that. But when we brought this code to
lmno we violated that assumption by using "box-sizing: border-box" on
the page, (making the padding be counted in computing the width of the
page.

The result of that was that the actual content of the page was only
620px and with actual paragraphs of text included now as part of the
empires client, it's clear that that was narrower than we really want.

So, in this commit, we account for the border-box semantics by using a
maximum page width of 820px (padding inclusive) so that the actual
page contents can be as wide as 720px.

Tweak the line-height down a bit

Now that we've added some actual paragraphs of text, (with the empires
client), it's plain to see that a line spacing of 1.5 is just a bit
too much. It just looks better a bit smaller like this.

empires: Adapt HTML to use 'form-field' instead of 'form-row' class

The top-level style.css uses this slightly different (but more
accurate) class naming. By adapting to it here, we also simplify the
empires-specific CSS file to not need to define its own form layout.

empires: Defer to top-level style sheet for as much as possible

Most of the top-level lmno style.css was originally copied from the
style.css file from empires-html in the first place. So there was a
lot od fuplication in these files.

In this commit, we reference the top-level style.css from the empires
HTML file and drop from the empires style.css file all directives that
already exist above.

Remove the reset.css from the empires sub-directory

Instead, just pointing up to the top-level one instead, (which happens
to be identical anyway).

Drop the Makefile from the empires directory

The top-level Makefile knows how to deploy all content including all
sub-directories, so we don't need a lower-level Makefile at all.

Merge in empires-html client

This HTML client for the empires game was originally developed in a
separate repository (and at the top-level).

In order to create this commit, I first rewrote the history of the
empires-html repository with:

git-filter-repo --path-rename '':empires/

to move all of its content down into the empires sub-directory.

I then fetched things over to thi repository with:

git fetch ../empires-html-filtered
        git merge --allow-unrelated-histories FETCH_HEAD

Going forward, we can develop the empires client within a
sub-directory of the lmno.games content (so they can share common
resources such as reset.css and style.css, etc.).

Populate the name fields in site.webmanifest

It's odd that the realfavicongenerator.net site doesn't ask for these
names. If it's going to go to the trouble of creating this resource it
might as well ask for the information it needs to create it correctly.

Point to various favicon resources in the <head> of the index page

This is a direct copy/paste from the recommendations of
https://realfavicongenerator.net

Add many assets expanded from lmno.png

These are all directly as generated by https://realfavicongenerator.net
by selecting a couple of arbitrary background colors in a couple places.

Add a very simple LMNO logo

Aiming at creating a favicon, etc. from this.

Add simple JavaScript processing of game ID form submission

All we are currently doing so far is getting the 404 return status and
properly plumbing that through to a message area.

Remove percentage units from grid column sizing

Richard recommends against using percentages here as it can be
surprising which size the percentage is computed against. This usage
of fr and em units should likely do what we want. (Note: We're not
actually exercising this currently, so we'll need to revisit this once
we add any 2-column field inputs.)

Add a little universal padding to the page

Regardless of how tiny the display is, we do want at least _some_
padding.

Refine the Game ID input field

Here we restrict it to 4 characters, force the input to uppercase,
disable autocomplete (since we don't expect intentional reuse of game
ID codes), and provide some instruction in the placeholder.

Add some basic styling for form input fields

Compared to browser defaults this provides larger font sizes and a
more modern flat aesthetic with a simple color scheme.

Never allow the background body color to be seen on a tiny screen

This breaks the illusion of "full screen" which we want to maintain on
small devices.

Add some responsive layout for the page itself

This is designed to use all the space available on a small device
(such as a phone) but then to smoothly allow some distinctly-colored
background to be visbile on a large device while maxing out the page
width at a reasoable maximum width.

This styling change does introduce a new containing "page" div around
the content.

Add a simple form for joining a game

Note: This doesn't actually do anything yet.

Add styling for some mobile-friendly forms and form fields

These fields will reponsively decide whether to layout in 1 or 2
columns depending on whether the fields are declared as "small",
"medium", or "large" and the width of the browser's screen.

Add the most basic of font styling

Simply choosing a sans-serif font for the body as well as some larger
(and bold) font sizes for h1 and h2 headers.

Add a reset CSS stylesheet

This eliminates basically all browser default styling (which differs
from browser to browser anyway). So this does not give any _nice_
styling but it does give a consistent baseline to start with.

Thanks to Eric Meyer for this stylesheet which was obtained (public
domain) from his website at:

https://meyerweb.com/eric/tools/css/reset/

Add DOCTYPE and "meta charset" tag.

I don't know what the DOCTYPE tag even does, but here it is.

And I really wish the world were already defaulted into utf-8 by now,
but apparently not without an explicit indication. Oh well.