Fix #10 add prefix to new afforms to prevent name conflicts

Remove unnecessary registerField process

GUI - set default permission for new forms

Update docs to reflect less metadata in default afform scope

AfformScanner - Just use the long cache

The long cache didn't exist when this class was first created, but it seems
better suited. #knockonwood

AfformScanner - Simplify cache. Fix CLI/web sync bug.

Example bug:

1. Find a packaged (non-overriden) form - e.g. `mockPage`
2. Run `cv api4 Afform.update +w name=mockPage +v permissions='*always allow*'
3. Run `curl http://localhost/civicrm/mock-page`
4. Observe: the page-load fails even though the permissions say it should work

The call to `Afform.update` should trigger a cache-clear, but it only fixes
on the CLI...  because the CLI and web have different runtime IDs.

The runtime-id was included preventively in anticipation that oddball
multisite arrangements might need to store these things separately.  But I
think it's overdone, because the runtime-ID factors in things like
`SCRIPT_FILENAME` which has no bearing on the whether to use the same cache.

Let's KISS and *if* there's any kind of multisite issue, then we can revisit.

Toward #6 - use API instead of scanner to retrieve afforms

GUI - dropdown select for permissions field

(NFC) Expand docblock for afform_civicrm_permission_check()

afform_{html,gui} - Allow editing the `permission` via web UI

afform_{html,gui} - Require "administer CiviCRM" to open editor

(REF) AfformSaveTrait - Extract helper $isChanged

I was originally expecting to need to flush the menu whenever the
`permission` changed.  That's not necessary now (because the true permission
check is deferred until it's needed), but the cleanup may still be helpful
in the future (e.g.  if we enable nav-menu integration or change the way
permissions are implemented).

Afform.{prefill,submit} - APIs should respect `permission`

AfformUsageTest - Add a basic test case of prefill/submit APIs

Enforce customizable `permission` for server routes. Add E2E test for server-routes.

Afform.get - Fix warning/test-failure when trying to load non-existent record

afform_mock - The extra dep should be a real module

Using a real Angular module means that the page can be opened in an E2E test.

Store 'permission' property for each form

info.xml - Bump minimum version. Needs revised hook_civicrm_angularModules.

Generate partials via callback

Technically, it's two changes:

1. Changing `snippets` to `partialsCallback` to reduce the amount of upfront IO/memory.
2. Changing the mocked-up filename to start with `~/theAngModule/`. So modules implemented in
   afform look more look other modules. Makes it work with `cv ang:html:list` and `cv ang:html:show`.

Rename modelListCtrl => afform

Fix afform partial name

ng-include was failing with ~afform* but works with ~/afform*

Use dynamic snippet for afform module layout.

Remove redundant afformStandalone file

Merge afField module into af module

GUI - Add option to hide field labels

afform_gui - Tweak nav label

Fix ngRepeat syntax error

afform_gui, afform_html - Refresh after reverting

afform_gui, afform_html - Adjust "Revert" button based on actual status

Afform.get - Return computed fields, `has_local` and `has_packaged`

afform_gui - Add nav item under "Administer => Customize Data and Screens"

afform_gui - Add skeletal upgrader

Stricter directives with better docs

GUI - Rename af-block => af-container

Free up the term af-block to refer to something more specific than a container.

Prettier json

Fix handling of non-breaking spaces

See https://stackoverflow.com/questions/59215211/why-does-domdocument-mess-up-unicode-nonbreaking-spaces

In shallow mode, only convert markup to array that the GUI editor understands.

Any markup not using a tag/class/attribute understood by the GUI editor
will have its contents preserved "as-is" in a "#markup" string.

Add api/v4/formatExamples/stylized.php

Format whitespace in aff.html files

Adds api options for use in GUI editor to autoformat html whitespace.
Results in much nicer looking markup!

AfformTest - Add coverage for weirdly named file.

Also: Clarify that the API input is a formName and not strictly a
directiveName.

Api improvements and test fix

Improve efficiency by not fetching layout if not needed in api.get
Fix test failure by correctly merging existing metadata during update

Remove client_route for now; might be yagni

Use canonical name in api.afform.get

Names were being munged in the api which led to a mismatch between
filenames and afform names.

GUI: Correctly handle naming a newly created form

GUI: Add new block to the top

Creates new items at top of block, underneath the fieldset legend if present

GUI: Add wysiwyg markup block

Display improvements

GUI: Improve adding/removing entities in correct order

GUI: use strict

GUI: Fix entity values selector

GUI: Better widget for editing input type select

GUI Add controls for text color, block border & block background color

GUI: Cleanup menus

GUI Validate drag-n-drop actions

Prevent fields from being moved outside their entity fieldset(s)
Prevent fieldsets from being dragged into other fieldsets

GUI Fix number field style

Edit option lists

GUI: Config fields

Perform deep merge on fieldDefn.input_attrs

Core: Set breadcrumb as well as title

GUI: Entity config

GUI: Entity tab style improvements

GUI: Add/remove block buttons

GUI: Refactor entity panel to directive & add field search

GUI configure form buttons

Don't write field defn unless changed

GUI: Bare bones field style

GUI: Add block button

Improve admin bar style

Save button for gui + api

Clarify docblock

Configure layout style of blocks

Dynamic option lists for select elements

This should respond better to changes in the model.

Add forms, add/remove entities

Fixes #4 - html encode injected properties and enable test

Fields drag n drop

WIP canvas

Remove convertTextNodes

The api now returns them as an array so we don't need to worry about this on the client side.

WIP fields

Config forms - values section

Horizontal tabs

Add some metadata

WIP beginning work on GUI

(REF) AHQ::makeRoot() - Extract helper from FormDataModel

FilterTest - Add basic unit test for the 'defn="..."` injection

(REF) _afform_html_filter() - Extract method for unit-testing

(NFC) Small cleanup

(REF) AfformScanner::getLayout() - Extract new method

Fix parser to work with nested fields

Fields should be allowed to be inside other tags as long as they're
contained in an af-fieldset.

Add bin/test-all.sh

Fix warnings for `#text` format

af-fieldset - More updates for switching E=>A

Restrict af-fieldset directive to A not E

The af-fieldset directive was ambiguiously set to restrict: "AE"
but only "E" was supported. I want to pick one and stick with it, and
I prefer "A" because the fieldset is also a container, so div or fieldset
seem like the appropriate tag names.

ArrayHtml - Change text node format from string to array

Everything in the arrayHtml is associative exept text nodes were just strings.
That made it difficult to loop through the whole thing in javascript, so
this updates the format to be consistent with everything else.

ArrayHtml - Treat `<af-entity/>` and `<af-field/>` as self-closing tags

ArrayHtml - Encode self-closing HTML tags (`<img />`, `<br />`) normally

ArrayHtml - Support comments

Before
------

HTML comments appear in the array as NULL values

After
-----

HTML comments appear in the array as `['#comment' => '...']`

Technical Notes
---------------

* Considered using `['#tag' => 'comment', '#children' => '...'], but this is ambiguous when you
  have a node/tag named '<comment>'
* Considered using `['#tag' => 'comment', '#children' => '...'], but it's needlessly difficult to
  extract the comment text from under `'#children'`.

Fix forms autofill with new dataModel

The formDataModel is now an object rather than an array.
This also changes the array key to match what's used in testAfform.aff.html:
url-autofill instead of af-url-autofill

(BC Break) Change shallow+deep formats to begin with an array of elements

Before: In the shallow+deep representations of `layout`, the root array
has a `#tag` and `#children`.

After: The root array is just list a list of children.

Comment: This is a more accufrate representation of how HTML partials are
often written.

FormDataModel::parseFields() - Rename param for clarity

This function uses a recursive algorithm to scan subtrees.  Each call to the
algorithm is a particular HTML element.