markdown.h

/*
 * Copyright (c) 2009, Natacha Porté
 * Copyright (c) 2011, Vicent Marti
 *
 * Permission to use, copy, modify, and distribute this software for any
 * purpose with or without fee is hereby granted, provided that the above
 * copyright notice and this permission notice appear in all copies.
 *
 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 */

#ifndef COMMON_FORMATS_MARKDOWN_H
#define COMMON_FORMATS_MARKDOWN_H

#include "common/scummsys.h"

namespace Common {

class String;

#define SUNDOWN_VERSION "1.16.0"
#define SUNDOWN_VER_MAJOR 1
#define SUNDOWN_VER_MINOR 16
#define SUNDOWN_VER_REVISION 0

/********************
 * TYPE DEFINITIONS *
 ********************/

struct SDDataBuffer;

/* mkd_autolink - type of autolink */
enum MKDAutolink {
    MKDA_NOT_AUTOLINK,  /* used internally when it is not an autolink*/
    MKDA_NORMAL,        /* normal http/http/ftp/mailto/etc link */
    MKDA_EMAIL,         /* e-mail link without explit mailto: */
};

enum mkd_tableflags {
    MKD_TABLE_ALIGN_L = 1,
    MKD_TABLE_ALIGN_R = 2,
    MKD_TABLE_ALIGN_CENTER = 3,
    MKD_TABLE_ALIGNMASK = 3,
    MKD_TABLE_HEADER = 4
};

enum mkd_extensions {
    MKDEXT_NO_INTRA_EMPHASIS = (1 << 0),
    MKDEXT_TABLES = (1 << 1),
    MKDEXT_FENCED_CODE = (1 << 2),
    MKDEXT_AUTOLINK = (1 << 3),
    MKDEXT_STRIKETHROUGH = (1 << 4),
    MKDEXT_SPACE_HEADERS = (1 << 6),
    MKDEXT_SUPERSCRIPT = (1 << 7),
    MKDEXT_LAX_SPACING = (1 << 8),
};

struct SDStack {
    void **item;
    size_t size;
    size_t asize;
};

/* sd_callbacks - functions for rendering parsed data */
struct SDCallbacks {
    /* block level callbacks - NULL skips the block */
    void (*blockcode)(SDDataBuffer *ob, const SDDataBuffer *text, const SDDataBuffer *lang, void *opaque);
    void (*blockquote)(SDDataBuffer *ob, const SDDataBuffer *text, void *opaque);
    void (*blockhtml)(SDDataBuffer *ob,const  SDDataBuffer *text, void *opaque);
    void (*header)(SDDataBuffer *ob, const SDDataBuffer *text, int level, void *opaque);
    void (*hrule)(SDDataBuffer *ob, void *opaque);
    void (*list_start)(SDDataBuffer *ob, const SDDataBuffer *text, int flags, void *opaque);
    void (*list)(SDDataBuffer *ob, const SDDataBuffer *text, int flags, void *opaque);
    void (*listitem)(SDDataBuffer *ob, const SDDataBuffer *text, int flags, void *opaque);
    void (*paragraph)(SDDataBuffer *ob, const SDDataBuffer *text, void *opaque);
    void (*table)(SDDataBuffer *ob, const SDDataBuffer *header, const SDDataBuffer *body, void *opaque);
    void (*table_row)(SDDataBuffer *ob, const SDDataBuffer *text, void *opaque);
    void (*table_cell)(SDDataBuffer *ob, const SDDataBuffer *text, int flags, void *opaque);


    /* span level callbacks - NULL or return 0 prints the span verbatim */
    int (*autolink)(SDDataBuffer *ob, const SDDataBuffer *link, MKDAutolink type, void *opaque);
    int (*codespan)(SDDataBuffer *ob, const SDDataBuffer *text, void *opaque);
    int (*double_emphasis)(SDDataBuffer *ob, const SDDataBuffer *text, void *opaque);
    int (*emphasis)(SDDataBuffer *ob, const SDDataBuffer *text, void *opaque);
    int (*image)(SDDataBuffer *ob, const SDDataBuffer *link, const SDDataBuffer *title, const SDDataBuffer *alt, const SDDataBuffer *ext, void *opaque);
    int (*linebreak)(SDDataBuffer *ob, void *opaque);
    int (*link)(SDDataBuffer *ob, const SDDataBuffer *link, const SDDataBuffer *title, const SDDataBuffer *content, void *opaque);
    int (*raw_html_tag)(SDDataBuffer *ob, const SDDataBuffer *tag, void *opaque);
    int (*triple_emphasis)(SDDataBuffer *ob, const SDDataBuffer *text, void *opaque);
    int (*strikethrough)(SDDataBuffer *ob, const SDDataBuffer *text, void *opaque);
    int (*superscript)(SDDataBuffer *ob, const SDDataBuffer *text, void *opaque);

    /* low level callbacks - NULL copies input directly into the output */
    void (*entity)(SDDataBuffer *ob, const SDDataBuffer *entity, void *opaque);
    void (*normal_text)(SDDataBuffer *ob, const SDDataBuffer *text, void *opaque);

    /* header and footer */
    void (*doc_header)(SDDataBuffer *ob, void *opaque);
    void (*doc_footer)(SDDataBuffer *ob, void *opaque);
};

/*********
 * FLAGS *
 *********/

/* list/listitem flags */
#define MKD_LIST_ORDERED    1
#define MKD_LI_BLOCK        2  /* <li> containing block data */

#define REF_TABLE_SIZE 8

struct LinkRef;

class SDMarkdown {
public:
    SDCallbacks _cb;
    void *_opaque;

    LinkRef *_refs[REF_TABLE_SIZE];
    byte _active_char[256];
    SDStack _work_bufs[2];
    uint _ext_flags;
    size_t _max_nesting;
    int _in_link_body;

    SDMarkdown(uint extensions, size_t max_nesting, const SDCallbacks *callbacks, void *opaque);
    ~SDMarkdown();

    Common::String render(const byte *document, size_t doc_size);

    void version(int *major, int *minor, int *revision);
};

/* SDDataBuffer: character array buffer */
struct SDDataBuffer {
    byte *data;     /* actual character data */
    size_t size;    /* size of the string */
    size_t asize;   /* allocated size (0 = volatile buffer) */
    size_t unit;    /* reallocation unit size (0 = read-only buffer) */
};

/* sd_bufput: appends raw data to a buffer */
void sd_bufput(SDDataBuffer *, const void *, size_t);

} // end of namespace Common

#endif // COMMON_FORMATS_MARKDOWN_H