Since this script can be reloaded in the same scope.

Fixes issue #387.

Also changed output to reflect slog.c more closely. I suppose only one of
of these 2 "utilities" to read csts.tab should exist at some point. :-)

Also added suport for "-r" and "-t" to be more modern and *nixy.

To match behavior of changed xpdev->byte_estimated_to_str().

If the caller wants a 'B' suffix, they can add it.

Configured in sbbs.ini [web] by setting:

 FileVpathPrefix = /files/
 FileIndexScript = webfileindex.ssjs

And optionally (if you want your vhosts to get filebase access):

 FileVPathForVHosts = true

You can use an .xjs file if you prefer.

Is anyone actually using sutils.js?

DDLightbarMenu can now optionally call its OnItemNav function when
it's first displayed.  By default this behavior is disabled, but it
can be enabled by setting the (new) callOnItemNavOnStartup property
to true.

Supports mixed Ctrl-A and ANSI messages.

ANSIs of any length should display correctly.

ANSIs wider than 79 columns will be truncated (not horizontally scrollable).

Animated ANSIs will not render with their animation sequences in tact. :-(

Create expand_ctrl_a() method that expands Ctrl-A attribute codes in a string
into ANSI escape sequences.

If set to true, when setting the ANSI property, rather than throwing away
vertically "scrolled" lines, just keep extending the height to accommodate the
new required vertical size (height).

menu after the user types an item number to select/highlight it. Also,
added 2 new color settings to specify the color to use for writing the
item numbers: itemNumColor (for non-highlighted items) and highlightedItemNumColor
(for the current highlighted item).

for Andre

So you have multiple IRC servers configured in modopts.ini and
you want different channel list per server? Just add more
keys to the modopts.ini [chat_sec] section of the form:
<server>=<channel_list>

Where <server> is the IRC server's host name (e.g. irc.synchro.net)
and <channel_list> is a comma-separated list of channels to override
the default list of channels (set with the "irc_channel" key).

For DesotoFireflite (VALHALLA)

ddfilelister version 2.05 - Now makes use of the user's extended file description setting: If
the user's extended file description setting is enabled, the lister will now show extended file
descriptions on the main screen in a split format, with the lightbar file list on the left and
the extended file description for the highlighted file on the right.
Also, made the file info window taller for terminals within 25 lines high.
This should resolve issue #363 .
This update to ddfilelister also requires the included update to dd_lightbar_menu.js and the
new attr_conv.js.

Note: TEXT_TEXT is actually off-by-one here. I suppose there's no need/use for that value anyway.

Fix issue #372

The default (when no argument to the '-l' option is provided) is to use
the last_few_callers value from the modopts.ini file. This was broken.

If modopts.ini [logonlist] last_few_days is set (to a number), that will
dictate the maximum number of previous days to pull last few callers from
(e.g. set to '0' for previous behavior).

Also, '-l' can now be used with a command-line option (e.g. '-l <num>')
to specify the number of callers to display (overriding the modopts.ini
last_fwe_callers value).

This should address issue (feature request) #371.

If days_ago argument is undefined (as is the case when performing
a "last few callers" query/list), then pull upto the maximum last
number of callers from previous days as necessary.

Part of fix for issue #371

An extra comma was being added after the control sequences
An empty color control sequence was not handled. It is supposed to
remove all color schemes.

When selecting quote lines in a reply message, SlyEdit now remembers the
position in the quote selection menu so that the quote menu isn't always
at the top whenever it's opened again.  This issue may have been introduced
when SlyEdit was refactored to use DDLightbarMenu for its lightbar stuff.

e.g. foodfite.com will match FOODFITE.COM or FoodFite.COM

(the MD5 sum is insuring it's the right file anyway).

This makes the view instant message logic more easily accessible from other
places (e.g. menus or whatever).

Add (V)iew command the private message (^P) prompt while we're at it.
Users don't normally discover ;string commands on their own.

postfile.js still should be used for adding a single file to a filebase,
but when updating a single file, this seemed like a simple enhancement.
It also allows filtering of files to be added by wildcard (e.g. *.zip),
so potentially useful for adding files too.

Address enhancement request #348

TARDIS (Quarkware BBS, the Ruby BBS), uses just \n for QWK message
line deliniation, but we were expected \r\n terminated lines here.
Also, apparently there was trailing white-space on the "json-end"
line, so handle that case too.

This addresses the gitlab issue #130.

Also, prompt for confirmation when [D]eleting the file.

Also, allow modopts.ini customization of this script via keys
in the new (optional) [automsg] section:

prompt (defaults to text.dat AutoMsg)
sysop_prompt (defaults to hard-coded string)
intro (defaults to hard-coded string)
header_fmt (defaults to text.dat AutoMsgBy)
user_fmt (defaults to hard-coded string)
line_fmt (defaults to hard-coded string)
max_line_len (defaults to 76)

On Windows, CRs in extended descriptions could result in output of
\r\r\n which could be displayed as 2 newlines (e.g. in notepad.exe).
Since the \n -> \r\n expansion already happens on Windows stdout,
we don't want them in the processed input (file metadata).

As reported by DesotoFireflite (VALHALLA), thank you!

As pointed out by DesotoFireflite (VALHALLA), both the file's
short/normal description and the extended description were being
included in all file listings. This is probably want most sysops
will want since the extended description is often used as the content
of the short/normal description, resulting in repeated content. So,
by default, if there is an extended file description, don't output
the short/normal file description.

If you want to include *both* the short and extended descriptions
(for files that have both), include both the -ext and -desc command
line options.

Added options:
 -count
 -all_subs
 -hide_zero

This allows this script to be used to create counts of messages in the groups.
Typical use: Stats on new messages in the last x days.

Inspired by filelist.js (which is really *only* for use offline),
added support to run via JSexec or timed event with command-line
options to control the output format, sorting, and msg-age range.

Try this Mewcenary (EXTRICAT)

a file search (via filespec, description, or new files since last scan).
A command-line parameter, -MODE, specifies which search to perform
(search_filename, search_description, or new_file_search for searching;
list_curdir lists files in the user's current directory, which is the
default).

Since we install archive.js as the viewer for '*' by default, we expect
it to be asked to list non-archive file-types frequently, so don't be
too alarmist about it.

As seen logging on to WLARB ("too")