Use built-in php function to do what we were trying to do with str_replace

Code comment

Revert "Reinstate parsing of data from the form"

This reverts commit d31206f9e08703ae4f11b7e34673d7ece92b1630.

Support is_primary fields and boolean options.

Civi 5.23 changes boolean options to be real true and false instead of '1' and '0'
so added version bump to keep in step.

More efficient select options handling

The afField.getOptions function was causing infinite recursion by recreating the boolean options array every time.
Passing this variable by refernce solves the problem, and adding "track by" to the ng-repeat follows best-practices for efficiency.

Reinstate parsing of data from the form

This means that data can be set in an embedded form e.g

 <af-entity data='{name_a : options.name_a,  name_b : options.name_b, is_name_b_nickname: options.is_name_b_nickname, is_name_b_inferior: options.is_name_b_inferior}' .... />

In this case the options.name_as comes from the directive that instantiates this afform

Increment suggested version to reflect info.xml

Arguably afform still works on older versions but breaking changes have happened & if people
use it on older you want a buyer-beware type feeling

Release v0.4

Loosen restrictions on file names - allow underscores

Use api to get directive/module names

Rename custom blocks and optimize api get by file/module/directive name

Api - output module_name & directive_name

Load join blocks primary first

GUI - improve menu button appearance

GUI - simplify menus; only add items from palette

Improve drag-n-drop placeholder & validation

Fix loading fields for contact type blocks

Rename blocks & require form name

GUI - Add block fields to field palette

GUI - Implement Save Block feature

Implement Address block with chainSelect state/county

GUI - present Individual/Organization/Household as seperate entities

Also adds per-contact-type default name blocks.

Refactor af-block directive into af-repeat and af-join

This allows mix-n-match between blocks and repeatable things, allowing
entity fieldsets to be repeated, as well as arbitrary non-repeatable blocks.

Implement afform blocks for multi-value custom groups

Implement afform blocks for Email, Phone, IM, Website

Blocks are reusable, repeatable afforms that extend other entities

Update git clone url

Note other updates around installation still needed

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